USER-TO-USER 

DOSKEY Macro Tips 

BY NEIL J. RUBENKING 



CREATING A DVORAK KEYBOARD 

DVORAK.SCR (Figure 1) produces a 
memory-resident utility requiring only 
112 bytes of RAM. When installed, the 
utility enables the Dvorak keyboard lay- 
out shown in Figure 2. When Scroll Lock 
is OFF, the Dvorak layout is active. 
When Scroll Lock is ON, the QWERTY 
layout is active. 

DVORAK.COM makes use of inter- 
rupt 15h, service 4Fh, so computers with 
a BIOS older than January 1986 may not 
be able to use it. The program is intended 
for use with DOS; Windows already in- 
cludes a Dvorak keyboard layout. 

In all, 33 keys are translated. Note that 
there are minor Dvorak variants dealing 
with the quote, slash, and semicolon keys; 
you may find other Dvorak layouts that 
place these keys differently. Key redefini- 
tion programs that use interrupt 16h can 
be used with this program in their normal 
fashion. 

Create DVORAK.SCR with an 
ASCII editor. Be sure to put a carriage 
return after the final Q and a blank line 
before the R CX line. To create the pro- 
gram, enter DEBUG < DVORAK . SCR at the 
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DOS prompt, or you can download 
DVORAK.ZIP from the Utilities/Tips 
Forum on PC MagNet. 

David M. Dibble 
Riverside, California 

► PC MAGAZINE: There's a persistent ru- 
mor that the original purpose of the 
standard QWERTY keyboard layout 
was to prevent jammed keys by slowing 
down typists. Whether or not this is true, 
Dvorak aficionados insist that it speeds 
their typing by putting the most-used 
keys on the home row. DVORAK.COM 
lets you try this layout for yourself. 

The author warns that computers with 
a BIOS date before January 1986 may not 
be able to use DVORAK.COM. If you 
don't know the date on your computer's 



BIOS, you can find out easily enough. 
Load DEBUG and enter the following 
command: D FFFF : 5 L 8. The resulting 
line of information will include the BIOS 
date at the far right. Type Q and Enter 
to quit DEBUG. 

DVORAK.SCR is a rather long DE- 
BUG script, and presents many opportu- 
nities for error. You can catch any errors 
by creating DVORAK.COM with this 
command: 

DEBUG < DVORAK . SCR > DVORAK . LOG 

Now scan the .LOG file for the string "Er- 
ror. If the string appears, there was an 
error in the line above: fix it and try again. 
Only when DEBUG processes the script 
with no errors should you run the 
DVORAK program. 

DVORAK.COM saves memory ' 
disposing of its own copy of the DOS 
vironment. But if you check your mem- 
ory with DOS 5.0's MEM command or 
another memory-mapping utility, you'll 
see that DVORAK.COM takes 368 bytes 
(170 in hexadecimal), not 112. It's true 
that the program code takes only 112 



DVORAK.SCR 

Complete Listing 



N DV0RAK.COM 
A 100 
JMP 0168 
PUSHF 

CMP AH, 4F 
JZ 0112 
POPF 

JMP 010D 
POP BX 
STC 

JMP 0000:0000 

POPF 

PUSH BX 

PUSH DS 

MOV BX, 0040 

MOV DS, BX 

TEST BYTE PTR [00171,10 

POP DS 

JNZ 010B 

MOV AH, AL 

AND AH, 80 

AND AL, 7F 

CMP AL, 0C 

JB 0138 

CMP AL, 35 

JA 0138 

SUB AL, 0C 

MOV BX, 013E 

CS: 

XLAT 

OR AL, AH 



.-Jump to INITIALIZE 

;* 'BEGIN replace int 15h 

; called by Int 9 to translate scan codes 

;if function 4Fh, jump TRANSLATE 

; restore flags 

;jump ORIGINAL handler 

;D0_INT15 

.■ORIGINAL int 15h 
; TRANSLATE 



;DS to BIOS data area 
.•Scroll Lock on? 

;if on, use Qwerty keyboard. Jump D0_INT15 
; scan code to AH 

;save possible high bit, AH = 80h or 
;zero high bit 
; scan code in range? 
if not, jump BREAK 

Jump if high range to BREAK 
set up AL as pointer 

BX to address of KEY_LIST scan code table 

key values 12 - 53 (decimal) 
translate AL to new scan code. Key pressed, 
if BREAK, OR with 80h. Key released 



MOV . 
JMP 



DB 
DB 
MOV 
INT 
MOV 
MOV 
MOV 
MOV 
INT 
MOV 
MOV 
MOV 
INT 
MOV 
MOV 
INT 
MOV 
INT 
DB 

R CX 
A5 
W 
Q 



15 21 22 

IE 18 12 

0C 29 2A 2B 

32 11 2F 2C 

AX, 3515 
21 

[010E], BX 
[0110], ES 

AX. 2515 

DX, 0102 

21 

AX, [002C] 

ES, AX 

AH, 49 

21 

DX, 0192 



; restore function 4Fh 
.•Jump D0_INT15. KEY_LIST follows: 
1A IB 0E 0F 28 33 34 19 
2E 13 26 35 0D 1C ID 
16 17 20 23 14 31 IF 
2B 27 10 24 25 2D 30 



AH, 09 
21 

DX, 0168 
27 

0D.0A, 'DVORAK loaded. 



.■INITIALIZE. Above portion is TSR 

,-save original int 15h vectors 

; code to set interrupt 

; replacement int 15h address 

environment block 

; f ree our copy of environment 

,-load DX with SIGN_ON 
; display it 

;DX to INITIALIZE, area to place in memory 
,-go memory resident. SIGN_ON follows: 
, 0D, 0A, 24 



Figure 1: This DEBUG script generates a minuscule utility program that lets you choose between the regular QWERTY keyboard layout and the Dvorak layout. 
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Figure 2: The Dvorak keyboard layout supposedly promotes faster 
typing by putting the most often used keys on the home row. 



ESC ; 7 1 ; "c: " ;13; " 
cd\";13;"cls";13p 

A variation of this lets 
you send escape codes to 
control your printer di- 
rectly from the DOS 
prompt. First create the 
PESC macro by entering 
the line 

DOSKEY PESC=ECHO 
■ [$*$GPRN 



bytes, but the obligatory Program Seg- 
ment Prefix adds another 256. Even at 
368 bytes, it's amazingly tiny for what it 
does! 

DOSKEY MACRO TIPS 

The DOS 5.0 reference manual describes 
only a few of the tricks you can perform 
using DOSKEY macros. The manual in- 
dicates three ways, for instance, to exe- 
cute ANSI escape sequences: 

• using the PROMPT command 

• using TYPE to display a text file con- 
taining the ANSI sequences 



f 'sing E( HO in a batch Ble 



But it never suggests you can use a 
DOSKEY macro to execute ANSI es- 
cape sequences directly from the key- 
board: 



"([$* 

Here. "[ represents the escape character. 
To use the macro, type ESC followed by 
any ANSI codes at the DOS prompt. 
Once you've installed the macro, for ex- 
ample, you could enter the following 
command to program the Home key to 
change to the root directory of drive C: 
and clear the screen 



MACROTIP.BAT 

Complete Listing 



Then you can add the appropriate char- 
acters to accomplish your task. For exam- 
ple, the command 

PESC4"NThis is a test 

would print "This is a test" in double- 
wide italics on a printer that uses Esc 4 
for italics and Ctrl-N for double-wide 
printing. 

By omitting the escape character from 
this macro definition you can also define 
a line-printing macro that will send any- 
thing you type after LP to the printer: 

DOSKEY LP=ECHO $* $G PRN 

Since you can't enter the escape charac- 
ter directly from the keyboard, you'll 
need to use a text editor to create a batch 
file that defines the macro. To enter an 
escape or other control character using 
DOS 5.0's EDIT.COM, first press Ctrl- 
P and then the special key. The escape 
character appears as a left arrow. Some 
control characters, like Ctrl-L, are inter- 
cepted by the DOS editor. To enter these, 
press Ctrl-P followed by Alt-««, where 
ran is the ASCII code for the character. 
The following useful macro will 

eject a page from the printer 

when you type FF: 



0ECHO OFF 

REM === The " ( in the next two lines 

REM = = = = represents the escape character. 

DOSKEY ESC=ECHO " [ [$* 

DOSKEY PESC=ECHO "[$* $G PRN 

DOSKEY LP=ECHO $* $G PRN 

REM ===== The "L in the next line 

REM ==== represents the Ctrl-L character 

DOSKEY FF=ECHO "L $G PRN 

REM ==== The * [ in the next line represents 
^EM = === the escape character. 

CHO *[[0;81;"DOSKEY /m| sort | more" ; 13p 



Figure 3: This batch file creates four handy DOSKEY macros, and 
redefines the Home key so it will list the available DOSKEY macros. 



DOSKEY FF=ECHO "L $G PRN 

To enter ~L using the DOS edi- 
tor, type Ctrl-P, then Alt-12. 

Finally, if you use a lot of 
macros and can't remember 
them all, just add the following 
ANSI command to your mac- 
ros batch file so you can press 
Page Down to see a list of the 
available macro commands: 



ECHO" [ [ ; 81 ; " DOSKEY 
/m| sort |more" ; 13p 

Here again, the " [ after ECHO represents 
the escape character. 

Brian L. Zimmerman 
El Paso, Texas 

► PC MAGAZINE DOSKEY macros are a 
little like batch files, but they have their 
own special abilities and limitations. The 
biggest limitation is that the entire macro 
must fit on a single 127-character com- 
mand line, though within that line the $T 
special character can separate multiple 
commands. The strongest advantage is 
that DOSKEY macros are stored in 
memory, so they execute much faster 
than batch files. Also, even the smallest 
batch file takes one cluster (2K or more) 
of disk space, yet you can probably create 
all of your DOSKEY macros with a single 
batch file that's under 2K. 

Another virtue of DOSKEY macros, 
one that I wish were available to batch 
files, is their ability to access the com- 
mand line as a whole. Batch files can ac- 
cess individual command line elements 
using the replaceable parameters %1 
through %9. DOSKEY macros use $1 
through $9 for the same purpose, but the 
special character $* is replaced by every- 
thing that follows the macro name. The 
ESC, PESC. and LP macros above all use 
this special character. Note also that 
PESC and LP include the special charac- 
ter $G, which is replaced by the greater- 
than symbol when the macro runs. 

The May 26, 1992. User-to-User col- 
umn presented a BASIC program called 
SAVEMAC.BAS. Used in combination 
with a DOSKEY macro of the same 
name, this program creates LOAD- 
MAC.BAT, a batch file that recreates all 
active DOSKEY macros. When you're 
experimenting with various DOSKEY 
macros, it's handy to be able to save and 
restore them in this way. To create the 
four DOSKEY macros described above 
and redefine the PgDn key as well, just 
run the batch file MACROTIP.BAT 
shown in Figure 3 or download it from 
PC MagNet as MACROT.BAT. □ 

Share your latest DOS and system discov- 
eries through User-to-User. Seethe "How 
to Contact Us" sidebar in the Solutions 
column. 
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